Operator Library: Hardware Platform
This operator represents the image data interface between a grayscale line scan GigE Vision camera and VisualApplets. This operator requires one VisualApplets resource of type CAM. Set the resource index for the camera in the resource dialog. The resource index 0 maps the camera to port 0, index 1 to port 1, etc. Check 'Allocation of Device Resources' for more information.
This operator can be configured to support the different data formats specified by the GigE Vision standard. The following figure illustrates the data formats.
The packed formats require 3 bytes for transmitting 2 pixels. MONO8 and MONO8_SIGNED require only 1 byte per pixel. MONO10, MONO12 and MONO16 need 2 bytes per pixel.
Note
- MONO8_SIGNED is managed by the operator as MONO8 and the output link format will be set to UNSIGNED type. If a SIGNED link is required use CastType operator and change the link type to SIGNED.
- Bayer formats can be mapped to these Gray formats because the camera operator does not interpret the pixel content.
The parameterized format is converted to match with the parameterized output link format of the camera operator. The output link can be configured to several bit widths. Conversion is performed by adding bits to the lower bit positions if the camera format bit width is higher than the parameterized bit width in the output link. However, if the camera format bit width is less than the available bits at the output link, only the most significant bits are used.
Moreover, in the output link the maximum possible image dimensions have to be specified. The size of the actual transfered images however may be less but must not exceed this parameterized maximum. For the 1D image protocol, the height is ignored.
| Available for Hardware Platforms |
|---|
| microEnable IV VQ4-GE/-GPoE |
| Link Parameter | Output Link O |
|---|---|
| Bit Width | {8, 10, 12, 14, 16} |
| Arithmetic | unsigned |
| Parallelism | 4 |
| Kernel Columns | 1 |
| Kernel Rows | 1 |
| Img Protocol | VALT_IMAGE1D |
| Color Format | VAF_GRAY |
| Color Flavor | FL_NONE |
| Max. Img Width | any |
| Max. Img Height | any |
| PixelFormat | |
|---|---|
| Type | dynamic read/write parameter |
| Default | MONO8 |
| Range | {MONO8, MONO8_SIGNED, MONO10, MONO10_PACKED, MONO12, MONO12_PACKED, MONO16} |
|
This parameter specifies the data format of the connected camera. The format has to match with the camera configuration. |
|
The use of operator CameraGrayLine is shown in the following examples:
-
'GigE Vision Grayscale Line Scan Cameras'
Tutorial - Basic Acquisition
-
A line scan trigger is presented. The trigger includes an image trigger using a capture gate as well as a multi functional line trigger. External sources, an internal frequency generator or software trigger pulses can be used for trigger generation. The camera can be triggered via cable connection to the trigger ports or directly with ActionCommands. See here especially the documentation 'ActionCommand'. See also the Action Command SDK example under SDK_Examples\gbe\ActionCommands in your Framegrabber SDK installation folder.
Prev
